home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / ARexxTools / ButtonBar_v10.lha / ButtonBar.doc next >
Encoding:
Text File  |  1994-01-13  |  4.1 KB  |  139 lines
  1. ButtonBar v1.0 (13 Jan 94)
  2.  
  3.  
  4. Purpose
  5. =======
  6.  
  7. ButtonBar is a small utility to generate a window of user-defined buttons that
  8. will talk to the Arexx port of a suitable application.
  9.  
  10.  
  11. Usage
  12. =====
  13.  
  14. RX ButtonBar [template_file]
  15.  
  16. If "template_file" isn't supplied then a file requester will open so that a
  17. template file can be chosen. The directory that this opens in can be set by
  18. changing the line
  19.  
  20. template_dir = "s:"
  21.  
  22. to point to whatever directory you want to store the templates in.
  23.  
  24.  
  25. Installation
  26. ============
  27.  
  28. Simply copy ButtonBar.rexx to your Rexx: directory.
  29.  
  30. ButtonBar has been tested with and requires the following libraries:
  31.  
  32.   RexxSupport.library     v34.9
  33.   RexxArpLib.library      v3.0
  34.  
  35. These libraries can be found on most major anonymous ftp sites and BBSs.
  36.  
  37.  
  38. How to Use
  39. ==========
  40.  
  41. First thing is to make a template file or use one of the enclosed templates. The
  42. format of the .template file is as follows:
  43.  
  44. Screen Name
  45. Rows,Columns
  46. Font,Size
  47. X,Y
  48. button_text,arexx_command
  49.       :          :
  50.       :          :
  51.       :          :
  52. button_text,arexx_command
  53.  
  54.  
  55. Screen Name   - Name of the public screen you open the bar on
  56. Rows,Columns  - Number of rows and columns of buttons
  57. Font,Size     - The font and font size to use for the buttons
  58. X,Y           - Location of the top left corner of the button bar
  59. button_text   - Text to display in the button, 12 characters max
  60. arexx_command - Arexx command to send to the application
  61.  
  62. There are a few demo template files that you can use as an example of what can
  63. be done.
  64.  
  65.  
  66. Notes
  67. =====
  68.  
  69. You can have a bigger window than necessary if the rows or columns value is too
  70. big. It'll just be an empty window.
  71.  
  72.  
  73. Additional Thoughts
  74. ===================
  75.  
  76. It'd be nice to have a way for ButtonBar to watch for the public screen that
  77. it's "sitting" on. That way if the screen is going away ButtonBar would be smart
  78. enough to stop itself instead of having to close ButtonBar before whatever
  79. application closes. This would also make ButtonBar seem more natural to use.
  80.  
  81. It would also be nice if there was a way to send a command to an Arexx port with
  82. a time-out value so that if the calling program doesn't accept the command it
  83. doesn't hang ButtonBar til the end of time.
  84.  
  85. Since it seems that many applications on many platforms are going to having
  86. pictures in the buttons. Personally, it seems more obvious what the button does
  87. if a word is used, but who am I to say what's better? :) Anyway, if there's a
  88. way to have a brush or IFF on a button done via Arexx (or mostly Arexx) I'd
  89. appreciate it if somebody would drop me a line.
  90.  
  91.  
  92. Problems
  93. ========
  94.  
  95. The font that you select to be used in the buttons doesn't seem to want to
  96. work, at least for me. I didn't want to take out that option because it
  97. should be something that would work. It doesn't hurt anything (as far as
  98. I've found) to leave the "SetFont" in there. It just doesn't do anything :).
  99.  
  100. I've included Mike Groshart's little utility to return the font information
  101. for a particular screen. This is for handling the font support should I find
  102. a clue on the font problem.
  103.  
  104. Thanks
  105. ======
  106.  
  107. Mike Groshart gave me many tips, hints, and outright blocks of code in my quest
  108. to get this working.
  109.  
  110. Payment
  111. =======
  112.  
  113. EMail-ware. Send me email to either of the addresses below that you're using it.
  114.  
  115. Also, if you make a .template file for a particular application please send it
  116. my way. I'll be happy to include it in any future releases of ButtonBar.
  117.  
  118. Please also send me a note if you've come across a problem and I'll see what it
  119. takes to fix it. Or if you fix it yourself please send me your fix so that I can
  120. keep it current.
  121.  
  122. I don't see rewriting this in C or something else mainly because ButtonBar was
  123. done to see what it would take to do it. Although maybe that'll be something
  124. else interesting to do. Hmmm... :)
  125.  
  126.  
  127. Author
  128. ======
  129.  
  130. Greg Gerke
  131.  
  132. I can be reached at the following addresses:
  133.  
  134. FidoNet -- 1:285/24  Great White North - 14.4K - (402) 895-7716
  135.                                                  (402) 895-7998
  136.         -- 1:285/11  Omaha AmigaNet BBS - 14.4K - (402) 333-5110
  137.                                                   (402) 691-0104
  138. Internet - Greg_Gerke@IMD.Sterling.COM
  139.